Cross-Compilation toolchain

Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.

Overview

A cross-compilation toolchain is an essential tool for compiling programs for target devices (such as ARM architecture Quectel Pi H1) on a host (such as x86_64 architecture Ubuntu). This document describes how to obtain and deploy the cross-compilation toolchain for Quectel Pi H1.

System requirements

  • Operating system: Ubuntu 22.04 (recommended)

  • Architecture: x86_64

  • Disk Space: At least 5 GB available space

Download toolchain

Toolchain information

  • Platform: Qualcomm QCM6490

  • Architecture: ARMv8-2a

  • Graphics system: Wayland

  • Version: 1.3-ver.1.1

Deploy toolchain

Unzip installation package

After downloading, unzip the ZIP file:

unzip qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.zip

Execute installation script

Add executable permissions to the installation script and run it:

chmod +x qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.sh
./qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.sh

Select installation directory

After executing the script, the system will prompt you to enter the installation directory:

  • Default directory: Press Enter directly to use the default path

  • Custom directory: Enter your target installation path

After installation is complete, the script will prompt you with the SDK environment activation method.

Deployment example

../../../_images/image_UFpCb2TcDo0cZLxxLzFc6zubnAg.webp

Use the toolchain

Environment variable configuration

After deployment, you need to configure environment variables before use. Usually, you can activate the SDK environment with the following command:

source <installation_directory>/environment-setup-armv8-2a-qcom-linux

Tip: Replace <installation_directory> with your actual installation path.

Verify installation

You can verify that the toolchain is correctly installed with the following command:

$CC --version

If the cross-compiler version information is displayed, the toolchain has been successfully deployed.

FAQs

Q1: Installation script execution failed?

Solution:

  • Ensure the script has executable permissions

  • Check if disk space is sufficient

  • Confirm the system version is Ubuntu 22.04

Q2: Environment variables not effective after configuration?

Solution:

  • Confirm that the source command is executed successfully

  • Check if the installation directory path is correct

  • Try re-executing the source command in a new terminal window

Q3: How to make environment variables permanently valid?

Solution:

You can add the source command to the ~/.bashrc file:

echo "source <installation_directory>/environment-setup-armv8-2a-qcom-linux" >> ~/.bashrc
source ~/.bashrc

Next steps

After successfully deploying the cross-compilation toolchain, you can:

  • Develop kernel modules

  • Compile device drivers

  • Build applications

For more development related information, please refer to corresponding development documents.